feat(integrations): add Agno integration docs #1529

ohlava · 2025-04-10T16:43:26Z

This PR adds documentation for integrating Apify with the Agno framework, enabling users to enhance AI agents with any Apify Actor from the store.

Connected to PR#2566

Changes:

Added new file: sources/integrations/agno.md
Included code examples, prerequisites, and resources

Related Issues: Closes #1511

ohlava · 2025-04-10T20:07:44Z

@jirispilka

sources/platform/integrations/ai/agno.md

Co-authored-by: Michał Olender <[email protected]>

TC-MO

Small nitpick from my side, otherwise LGTM

sources/platform/integrations/ai/agno.md

Co-authored-by: Michał Olender <[email protected]>

ohlava · 2025-04-29T08:17:28Z

@TC-MO we can merge now

ohlava · 2025-05-06T12:38:04Z

This is ready

jirispilka · 2025-05-06T12:38:52Z

Cool. I'll review it today.

jirispilka

@ohlava Nice. Thanks! I left a couple of comments.
The major was that agent requires OPENAI_API_KEY

jirispilka · 2025-05-07T08:48:10Z

sources/platform/integrations/ai/agno.md

+
+### Prerequisites
+
+- *Apify API token*: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).  


Suggested change

- *Apify API token*: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).

- *Apify API token*: Obtain your API token from the [Apify console](https://console.apify.com/account/integrations).

- *OpenAI API key*: Get your API key from the [OpenAI platform](https://platform.openai.com/account/api-keys)

jirispilka · 2025-05-07T08:52:23Z

sources/platform/integrations/ai/agno.md

+from agno.agent import Agent
+from agno.tools.apify import ApifyTools
+
+# Initialize the agent with Apify tools
+agent = Agent(
+    tools=[
+        ApifyTools(
+            actors=["apify/rag-web-browser"],
+            apify_api_token="YOUR_APIFY_API_TOKEN"  # Replace YOUR_APIFY_API_TOKEN with your token 
+        )
+    ],
+    show_tool_calls=True,
+    markdown=True
+)
+
+# Fetch and display web content
+agent.print_response("Extract key details from https://docs.agno.com/introduction", markdown=True)


Suggested change

from agno.agent import Agent

from agno.tools.apify import ApifyTools

# Initialize the agent with Apify tools

agent = Agent(

tools=[

ApifyTools(

actors=["apify/rag-web-browser"],

apify_api_token="YOUR_APIFY_API_TOKEN" # Replace YOUR_APIFY_API_TOKEN with your token

)

],

show_tool_calls=True,

markdown=True

)

# Fetch and display web content

agent.print_response("Extract key details from https://docs.agno.com/introduction", markdown=True)

import os

from agno.agent import Agent

from agno.tools.apify import ApifyTools

os.environ["APIFY_API_TOKEN"] = "YOUR_APIFY_API_TOKEN" # Replace with your Apify API token

os.environ["OPENAI_API_KEY"] = "YOUR_OPENAI_API_KEY" # Replace with your OpenAI API key

# Initialize the agent with Apify tools

agent = Agent(

tools=[ApifyTools( actors=["apify/rag-web-browser"])],

show_tool_calls=True,

markdown=True

)

# Fetch and display web content

agent.print_response("Extract key details from https://docs.agno.com/introduction", markdown=True)

We also need to add OPENAPI key, otherwise I'm got:

agno.exceptions.ModelProviderError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY environment variable

Hence it make sense to add the both keys into env vars.

jirispilka · 2025-05-07T08:53:54Z

sources/platform/integrations/ai/agno.md

+:::tip Environment variable token
+
+You can also set the APIFY_API_TOKEN environment variable instead of passing it directly in the code.
+
+:::
+


Suggested change

:::tip Environment variable token

You can also set the APIFY_API_TOKEN environment variable instead of passing it directly in the code.

:::

Let's skip this suggestion

jirispilka · 2025-05-07T08:54:20Z

sources/platform/integrations/ai/agno.md

+
+:::
+
+### Advanced Scenario: Travel Planning Agent


Suggested change

### Advanced Scenario: Travel Planning Agent

### Advanced scenario: Travel planning agent

jirispilka · 2025-05-07T08:59:17Z

sources/platform/integrations/ai/agno.md

+from agno.agent import Agent
+from agno.tools.apify import ApifyTools


Suggested change

from agno.agent import Agent

from agno.tools.apify import ApifyTools

import os

from agno.agent import Agent

from agno.tools.apify import ApifyTools

os.environ["APIFY_API_TOKEN"] = "YOUR_APIFY_API_TOKEN" # Replace with your Apify API token

os.environ["OPENAI_API_KEY"] = "YOUR_OPENAI_API_KEY" # Replace with your OpenAI API key

jirispilka · 2025-05-07T08:59:38Z

sources/platform/integrations/ai/agno.md

+            ],
+            apify_api_token="YOUR_APIFY_API_TOKEN"


Suggested change

],

apify_api_token="YOUR_APIFY_API_TOKEN"

]

jirispilka · 2025-05-07T09:00:02Z

sources/platform/integrations/ai/agno.md

+
+:::
+
+### Available Apify Tools


Suggested change

### Available Apify Tools

### Available Apify tools

jirispilka · 2025-05-07T09:01:43Z

sources/platform/integrations/ai/agno.md

+## Configuration Options
+
+| Parameter                    | Type                | Default | Description                                                        |
+| ---------------------------- | ------------------- | ------- | ------------------------------------------------------------------ |
+| `apify_api_token`            | `str`               | `None`  | Apify API token (or set via APIFY_API_TOKEN environment variable)  |
+| `actors`                     | `str` or `List[str]`| `None`  | Single Actor ID or list of Actor IDs to register                   |


Suggested change

## Configuration Options

| Parameter | Type | Default | Description |

| ---------------------------- | ------------------- | ------- | ------------------------------------------------------------------ |

| `apify_api_token` | `str` | `None` | Apify API token (or set via APIFY_API_TOKEN environment variable) |

| `actors` | `str` or `List[str]`| `None` | Single Actor ID or list of Actor IDs to register |

Do we really need this table?

I think the examples are enough. This table does not add much value IMO

IMO it gives more structure to information and makes it more scannable. But given that it's only two options I think this could also be remade to text.

TC-MO · 2025-05-07T23:51:37Z

sources/platform/integrations/ai/agno.md

+- *Apify API token*: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).  
+- *Python environment*: Ensure Python is installed (version 3.8+ recommended).  
+- *Required packages*: Install the following dependencies in your terminal:


We use _ instead of * for emphasis

Suggested change

- *Apify API token*: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).

- *Python environment*: Ensure Python is installed (version 3.8+ recommended).

- *Required packages*: Install the following dependencies in your terminal:

- _Apify API token_: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).

- _Python environment_: Ensure Python is installed (version 3.8+ recommended).

- _Required packages_: Install the following dependencies in your terminal:

TC-MO · 2025-05-07T23:56:10Z

sources/platform/integrations/ai/agno.md

+## Configuration Options
+
+| Parameter                    | Type                | Default | Description                                                        |
+| ---------------------------- | ------------------- | ------- | ------------------------------------------------------------------ |
+| `apify_api_token`            | `str`               | `None`  | Apify API token (or set via APIFY_API_TOKEN environment variable)  |
+| `actors`                     | `str` or `List[str]`| `None`  | Single Actor ID or list of Actor IDs to register                   |


IMO it gives more structure to information and makes it more scannable. But given that it's only two options I think this could also be remade to text.

feat(integrations): add Agno integration docs

e62e777

ohlava requested a review from TC-MO as a code owner April 10, 2025 16:43

ohlava marked this pull request as draft April 10, 2025 16:43

Apply lint:md fix

1f768ee

jirispilka self-requested a review April 17, 2025 08:49

Merge branch 'master' into feat/agno-integration

a6f7e50

ohlava marked this pull request as ready for review April 17, 2025 09:11

ohlava mentioned this pull request Apr 17, 2025

Add better Apify integration docs with more examples agno-agi/agno-docs#183

Merged

dirkbrnd reviewed Apr 24, 2025

View reviewed changes

sources/platform/integrations/ai/agno.md Outdated Show resolved Hide resolved

dirkbrnd reviewed Apr 24, 2025

View reviewed changes

sources/platform/integrations/ai/agno.md Show resolved Hide resolved

jirispilka added the t-ai Issues owned by the AI team. label Apr 25, 2025

TC-MO requested changes Apr 28, 2025

View reviewed changes

ohlava and others added 3 commits April 28, 2025 22:44

Update sources/platform/integrations/ai/agno.md

f624111

Co-authored-by: Michał Olender <[email protected]>

Apply comment suggestions

36148d8

Merge branch 'master' into feat/agno-integration

97bbbb8

TC-MO approved these changes Apr 29, 2025

View reviewed changes

Apply style changes for :::notes etc.

cfd4b9d

Co-authored-by: Michał Olender <[email protected]>

Update sidebar position

abc37be

ohlava force-pushed the feat/agno-integration branch from 834bd22 to abc37be Compare April 29, 2025 08:26

ohlava added 3 commits April 29, 2025 10:26

Merge branch 'master' into feat/agno-integration

e6a9577

Merge branch 'apify:master' into feat/agno-integration

c169871

Remove apify-langchain dependence.md

3870730

ohlava requested a review from TC-MO May 6, 2025 12:37

jirispilka requested changes May 7, 2025

View reviewed changes

TC-MO requested changes May 7, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(integrations): add Agno integration docs #1529

feat(integrations): add Agno integration docs #1529

ohlava commented Apr 10, 2025 •

edited

Loading

ohlava commented Apr 10, 2025

TC-MO left a comment

ohlava commented Apr 29, 2025

ohlava commented May 6, 2025

jirispilka commented May 6, 2025

jirispilka left a comment

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

jirispilka May 7, 2025

TC-MO May 7, 2025

TC-MO May 7, 2025

TC-MO May 7, 2025


		### Prerequisites

		- Apify API token: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).

	- Apify API token: Obtain your token from the [Apify console](https://console.apify.com/account/integrations).
	- Apify API token: Obtain your API token from the [Apify console](https://console.apify.com/account/integrations).
	- OpenAI API key: Get your API key from the [OpenAI platform](https://platform.openai.com/account/api-keys)

	### Advanced Scenario: Travel Planning Agent
	### Advanced scenario: Travel planning agent

		from agno.agent import Agent
		from agno.tools.apify import ApifyTools

feat(integrations): add Agno integration docs #1529

Are you sure you want to change the base?

feat(integrations): add Agno integration docs #1529

Conversation

ohlava commented Apr 10, 2025 • edited Loading

ohlava commented Apr 10, 2025

TC-MO left a comment

Choose a reason for hiding this comment

ohlava commented Apr 29, 2025

ohlava commented May 6, 2025

jirispilka commented May 6, 2025

jirispilka left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ohlava commented Apr 10, 2025 •

edited

Loading